home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 11 / PC World Interactive 11.iso / mp3 / winamp / winamp19.EXE / FRONTEND.TXT next >
Encoding:
Text File  |  1998-01-13  |  6.2 KB  |  184 lines
  1. This file is only useful for people who are writing frontends for Winamp.
  2. Actually, it's useful for plugin authors too.
  3.  
  4.  
  5. There are some useful notes for VB programmers at the end of this file.
  6.  
  7.  
  8.  
  9. Psuedo IPC for frontends for Winamp v1.55+ (< 2.0)
  10.  
  11. This document is horribly [de]organized, and is pretty much just hacked
  12. together for people to use.
  13.  
  14. Winamp's window is found using:
  15. hwnd_winamp = FindWindow("Winamp v1.x",NULL);
  16.  
  17. #define WM_WA_IPC WM_USER
  18. // messages are sent to the winamp window using:
  19. result = SendMessage(hwnd_winamp,WM_WA_IPC,command_data,command);
  20.  
  21.  
  22. /* Messages available to send */
  23.  
  24. #define IPC_GETVERSION 0
  25. /*
  26.     IPC_GETVERSION is sent to the window, and the return value is the version
  27.         Version 1.55 = 0x1551
  28.         Version 1.6b = 0x16A0
  29.         Version 1.60 = 0x16AF
  30.         Version 1.61 = 0x16B0
  31.         Version 1.62 = 0x16B1
  32.         Version 1.64 = 0x16B3
  33.         Version 1.666 = 0x16B4
  34.         Version 1.69 = 0x16B5
  35.         Version 1.70 = 0x1700
  36.         Version 1.72 = 0x1702
  37.         Version 1.73 = 0x1703
  38.         Version 1.80 = 0x1800
  39.         Version 1.81 = 0x1801
  40.         Version 1.82 = 0x1802
  41.         Version 1.90 = 0x1900
  42.     the command_data parameter is 0.
  43.     so, 
  44.     if (SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_GETVERSION) != 0x1551)
  45.         MessageBox(NULL,"Error, Winamp 1.55 not found","Warning",MB_OK);
  46. */
  47.  
  48.  
  49. #define IPC_PLAYFILE 100
  50. /*
  51.     IPC_PLAYFILE is sent to the window for each char of a null terminated string of a file to ADD
  52.     to the playlist (it doesn't change the playing status). Note, if you pass a file with the extension
  53.     ".m3u" it will be treated as a playlist.
  54.     for example:
  55.         char *file = "C:\\download\\booga.mp3";
  56.         int x;
  57.         for (x = 0; x <= strlen(file); x ++)
  58.             PostMessage(hwnd_winamp,WM_WA_IPC,(LPARAM)file[x],IPC_PLAYFILE);
  59.     will add "C:\download\booga.mp3" to the end of the playlist
  60. */
  61.  
  62. #define IPC_DELETE 101
  63. /* 
  64.     IPC_DELETE deletes the internal Winamp playlist.
  65.         SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_DELETE);
  66. */
  67.  
  68. #define IPC_STARTPLAY 102
  69. /* 
  70.     IPC_STARTPLAY starts the playing.
  71.         SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_STARTPLAY);
  72. */
  73.  
  74. #define IPC_CHDIR 103
  75. /*
  76.     IPC_CHDIR is sent to the window for each char of a null terminated string of a directory to change to
  77.     for example:
  78.         char *dir = "C:\\Download";
  79.         int x;
  80.         for (x = 0; x <= strlen(file); x ++)
  81.             PostMessage(hwnd_winamp,WM_WA_IPC,(LPARAM)dir[x],IPC_PLAYFILE);
  82.     will change the winamp process to "C:\download" (useful for relative pathnames and loading playlists)
  83.  
  84. */
  85. #define IPC_ISPLAYING 104
  86. /*
  87.     IPC_ISPLAYING returns the status of playback.
  88.     If it returns 1, it is playing. if it returns 3, it is paused, if it returns 0, it is not playing.
  89.     If it returns something other than 1,3,or 0, something is screwed.
  90.     isplaying = SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_ISPLAYING);
  91. */
  92.  
  93.  
  94. #define IPC_GETOUTPUTTIME 105
  95. /*
  96.     IPC_GETOUTPUTTIME returns the position in milliseconds of the 
  97.           current song (lParam = 0), or the song length, in seconds (lParam = 1).
  98.     Returns -1 if not playing or error.
  99.         
  100.     song_pos = SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_GETOUTPUTTIME);
  101.     song_len = SendMessage(hwnd_winamp,WM_WA_IPC,1,IPC_GETOUTPUTTIME);
  102. */
  103.  
  104. #define IPC_JUMPTOTIME 106
  105. /*
  106.         *ONLY AVAILABLE IN v1.60+*
  107.     IPC_JUMPTOTIME sets the position in milliseconds of the current song (approximately)
  108.     Returns -1 if not playing, 1 on eof, or 0 if successful
  109.     SendMessage(hwnd_winamp,WM_WA_IPC,new_song_pos,IPC_JUMPTOTIME);
  110. */
  111. #define IPC_WRITEPLAYLIST 120
  112. /*
  113.         *ONLY AVAILABLE IN v1.666+*
  114.     IPC_WRITEPLAYLIST writes the current playlist to <winampdir>\\Winamp.pl
  115.     int cursong =  SendMessage(hwnd_winamp,WM_WA_IPC,0,IPC_WRITEPLAYLIST);
  116.     (cursong is the index of the current song in the playlist)
  117. */
  118.  
  119.  
  120. // THESE MIGHT CHANGE in the future :)
  121. //Also, you can send standard WM_COMMAND messages to the Winamp window (for other controls), including
  122. // Send using SendMessage(hwnd_winamp,WM_COMMAND,WINAMP_OPTIONS_EQ/*orwhatever*/,0);
  123.  
  124. // toggles the EQ window
  125. #define WINAMP_OPTIONS_EQ               40036
  126. // toggles the playlist window
  127. #define WINAMP_OPTIONS_PLEDIT           40040
  128. // turns the volume up a little
  129. #define WINAMP_VOLUMEUP                 40058
  130. // turns the volume down a little
  131. #define WINAMP_VOLUMEDOWN               40059
  132. // fast forwards 5 seconds
  133. #define WINAMP_FFWD5S                   40060
  134. // rewinds 5 seconds
  135. #define WINAMP_REW5S                    40061
  136. // the following are the five main control buttons, with optionally shift or control pressed
  137. // (for the exact functions of each, just try it out)
  138. #define WINAMP_BUTTON1                  40044
  139. #define WINAMP_BUTTON2                  40045
  140. #define WINAMP_BUTTON3                  40046
  141. #define WINAMP_BUTTON4                  40047
  142. #define WINAMP_BUTTON5                  40048
  143. #define WINAMP_BUTTON1_SHIFT            40144
  144. #define WINAMP_BUTTON2_SHIFT            40145
  145. #define WINAMP_BUTTON3_SHIFT            40146
  146. #define WINAMP_BUTTON4_SHIFT            40147
  147. #define WINAMP_BUTTON5_SHIFT            40148
  148. #define WINAMP_BUTTON1_CTRL             40154
  149. #define WINAMP_BUTTON2_CTRL             40155
  150. #define WINAMP_BUTTON3_CTRL             40156
  151. #define WINAMP_BUTTON4_CTRL             40157
  152. #define WINAMP_BUTTON5_CTRL             40158
  153.  
  154. // always goes to the previous song (unlike button 1), 1.666+
  155. #define WINAMP_PREVSONG                    40198
  156.  
  157. // pops up the load file(s) box
  158. #define WINAMP_FILE_PLAY                40029
  159. // pops up the preferences
  160. #define WINAMP_OPTIONS_PREFS            40012
  161. // toggles always on top
  162. #define WINAMP_OPTIONS_AOT              40019
  163. // pops up the about box :)
  164. #define WINAMP_HELP_ABOUT               40041
  165.  
  166.  
  167. /* A little about Visual Basic
  168. In VB, the SendMessage function does not work, you must use the SendMessageTimeout. 
  169. Otherwise, VB will not wait for WinAmp to return a value. Here's an example...
  170.     Dim Success as Long
  171.     Dim ReturnValue As Long
  172.     Success = SendMessageTimeout(WinampHandle, WM_USER, 0, 104, SMTO_BLOCK, 1000, ReturnValue)
  173.     MsgBox (ReturnValue)
  174. If you are sending commands, use this format;
  175.     Dim Success as Long
  176.     Success = PostMessage(WinampHandle, WM_COMMAND, 40022, 0)
  177. // -VB notes by Amal G.
  178. */
  179.  
  180.  
  181.  
  182. // hope this helps, 
  183. // -Justin [justin@nullsoft.com]
  184.